home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / ATLK / TN.ATLK.001 next >
Encoding:
Text File  |  1990-04-03  |  3.7 KB  |  95 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. AppleTalk
  7. #1:    Identifying AppleTalk
  8.  
  9. Revised by:    Jim Luther                                          March 1990
  10. Written by:    Dan Strnad                                       November 1988
  11.  
  12. This Technical Note describes the correct methods for identifying AppleTalk 
  13. under ProDOS 8 and GS/OS, as the ATLK ROM signature is no longer used.
  14. Changes since July 1989:  Added warning concerning ProDOS 8, version 1.4.
  15. _____________________________________________________________________________
  16.  
  17. To determine if an application has been launched over the network, refer to 
  18. the NetLaunch code fragment found in the AppleShare Programmer's Guide for the 
  19. Apple IIGS.
  20.  
  21. Under ProDOS, to identify both AppleTalk and the slot with which it is 
  22. associated for printing, refer to Apple II AppleTalk Technical Note #4, 
  23. Printing Through the Firmware.
  24.  
  25. To identify AppleTalk under ProDOS 8:
  26.  
  27. 1.  Issue an AppleShare GetInfo call.
  28. 2.  If there is no error result, AppleTalk is installed.
  29.  
  30.     InfoParams    DB  $00        ;Synchronous only
  31.                   DB  $02        ;GetInfo call number
  32.     InfoResult    DS  13         ;<- results returned here
  33.     
  34.     CheckATalk    JSR $BF00
  35.                   DB  $42        ;$42 command # for AppleTalk calls
  36.                   DW  InfoParams ;Parameter list address
  37.                   BCS NoATalk    ;handle the error
  38.     IsATalk       ...            ;AppleTalk installed when here
  39.     
  40.     NoATalk       ...            ;AppleTalk not installed when here
  41.  
  42. Warning:  Due to a bug in ProDOS 8, version 1.4, using the $42 call 
  43.           crashes ProDOS 8 if AppleTalk is not installed.  
  44.           Applications that use this routine to check for AppleTalk 
  45.           should ship with ProDOS 8 version 1.5 or greater, thus 
  46.           avoiding this bug.  (ProDOS 8 Technical Note #21, 
  47.           Identifying ProDOS Devices contains a routine which 
  48.           correctly identifies the presence AppleTalk under all 
  49.           versions of ProDOS 8.)
  50.  
  51. To identify AppleTalk protocols and AppleShare file system under System 
  52. Software 5.0:
  53.  
  54. 1.  Set up the parameter block for a GS/OS GetFSTInfo call using 
  55.     fstNum = 1.
  56. 2.  Issue the GetFSTInfo call.
  57. 3.  If the fileSysID is $0D the AppleShare FST and AppleShare are 
  58.     present.
  59. 4.  If a parameter out of range error ($53) results, the AppleShare 
  60.     file system is not present.
  61. 5.  Otherwise, if steps 3 and 4 are inconclusive, increment the fstNum 
  62.     and loop back to step 2.
  63.  
  64. To identify AppleTalk protocols, including LAP through PFI but excluding the 
  65. file system, under System Software 5.0:
  66.  
  67. 1.  Set up the parameter block for a GS/OS DInfo call using device 
  68.     number one.
  69. 2.  Issue the DInfo call.
  70. 3.  If the deviceID is $1D, the AppleTalk main driver and AppleTalk 
  71.     are present.
  72. 4.  If a parameter out of range error ($53) results, the AppleTalk 
  73.     protocols are not present.
  74. 5.  Otherwise, if steps 3 and 4 are inconclusive, increment the device 
  75.     number and loop back to step 2.
  76.  
  77. To identify AppleTalk protocols, including LAP through ASP but excluding the 
  78. file system, under System Software 4.0:
  79.  
  80. 1.  Issue an an SPGetStatus call
  81. 2.  If the call returns without error, AppleTalk is present.
  82.  
  83. Note:  With the release of System Software 5.0, earlier versions are not 
  84.        supported.
  85.  
  86.  
  87. Further Reference
  88. _____________________________________________________________________________
  89.   o  Inside AppleTalk
  90.   o  AppleShare Programmer's Guide for the Apple IIGS
  91.   o  GS/OS Reference
  92.   o  Apple II AppleTalk Technical Note #4, Printing Through the Firmware
  93.   o  ProDOS 8 Technical Note #21, Identifying ProDOS Devices
  94.  
  95.